package com.cencat.route.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.cencat.route.entity.Route;
import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

/**
 * 路由服务接口
 * 
 * @author cencat
 * @version 1.0
 * @since 2024-12-19
 */
public interface RouteService extends IService<Route> {

    /**
     * 分页查询路由列表
     * 
     * @param page 分页参数
     * @param routeStatus 路由状态
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 路由分页数据
     */
    IPage<Route> getRoutePage(Page<Route> page, Integer routeStatus, LocalDateTime startTime, LocalDateTime endTime);

    /**
     * 根据起点和终点查询路由
     * 
     * @param startLatitude 起点纬度
     * @param startLongitude 起点经度
     * @param endLatitude 终点纬度
     * @param endLongitude 终点经度
     * @param limit 限制数量
     * @return 路由列表
     */
    List<Route> getRoutesByPoints(java.math.BigDecimal startLatitude, java.math.BigDecimal startLongitude,
                                 java.math.BigDecimal endLatitude, java.math.BigDecimal endLongitude, Integer limit);

    /**
     * 根据路由编码查询路由
     * 
     * @param routeCode 路由编码
     * @return 路由信息
     */
    Route getRouteByCode(String routeCode);

    /**
     * 查询热门路由
     * 
     * @param limit 限制数量
     * @param days 天数
     * @return 热门路由列表
     */
    List<Route> getPopularRoutes(Integer limit, Integer days);

    /**
     * 查询最近路由
     * 
     * @param userId 用户ID
     * @param limit 限制数量
     * @return 最近路由列表
     */
    List<Route> getRecentRoutes(Long userId, Integer limit);

    /**
     * 创建路由
     * 
     * @param route 路由信息
     * @return 创建结果
     */
    boolean createRoute(Route route);

    /**
     * 统计路由数量
     * 
     * @param routeStatus 路由状态
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 路由数量
     */
    Long countRoutes(Integer routeStatus, LocalDateTime startTime, LocalDateTime endTime);

    /**
     * 查询路由统计数据
     * 
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 统计数据
     */
    List<Map<String, Object>> getRouteStatistics(LocalDateTime startTime, LocalDateTime endTime);

    /**
     * 更新路由状态
     * 
     * @param routeId 路由ID
     * @param routeStatus 路由状态
     * @param updateTime 更新时间
     * @return 更新结果
     */
    boolean updateRouteStatus(Long routeId, Integer routeStatus, LocalDateTime updateTime);

    /**
     * 更新路由使用次数
     * 
     * @param routeId 路由ID
     * @param usageCount 使用次数
     * @param updateTime 更新时间
     * @return 更新结果
     */
    boolean updateRouteUsageCount(Long routeId, Integer usageCount, LocalDateTime updateTime);

    /**
     * 批量更新路由状态
     * 
     * @param routeIds 路由ID列表
     * @param routeStatus 路由状态
     * @param updateTime 更新时间
     * @return 更新结果
     */
    boolean batchUpdateRouteStatus(List<Long> routeIds, Integer routeStatus, LocalDateTime updateTime);

    /**
     * 查询路由使用统计
     * 
     * @param routeId 路由ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 使用统计
     */
    Map<String, Object> getRouteUsageStats(Long routeId, LocalDateTime startTime, LocalDateTime endTime);

    /**
     * 查询路由性能统计
     * 
     * @param routeId 路由ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 性能统计
     */
    Map<String, Object> getRoutePerformanceStats(Long routeId, LocalDateTime startTime, LocalDateTime endTime);

    /**
     * 查询路由评价统计
     * 
     * @param routeId 路由ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 评价统计
     */
    Map<String, Object> getRouteRatingStats(Long routeId, LocalDateTime startTime, LocalDateTime endTime);

    /**
     * 查询路由排行榜
     * 
     * @param rankType 排行类型（1-使用次数，2-评分，3-距离，4-时间）
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @param limit 限制数量
     * @return 排行榜数据
     */
    List<Map<String, Object>> getRouteRanking(Integer rankType, LocalDateTime startTime, 
                                             LocalDateTime endTime, Integer limit);

    /**
     * 智能路由推荐
     * 
     * @param userId 用户ID
     * @param startLatitude 起点纬度
     * @param startLongitude 起点经度
     * @param endLatitude 终点纬度
     * @param endLongitude 终点经度
     * @param preferences 偏好设置
     * @param limit 推荐数量
     * @return 推荐路由列表
     */
    List<Map<String, Object>> getSmartRouteRecommendation(Long userId, java.math.BigDecimal startLatitude, 
                                                          java.math.BigDecimal startLongitude, java.math.BigDecimal endLatitude, 
                                                          java.math.BigDecimal endLongitude, Map<String, Object> preferences, Integer limit);

    /**
     * 查询路由拥堵情况
     * 
     * @param routeId 路由ID
     * @param currentTime 当前时间
     * @return 拥堵情况
     */
    Map<String, Object> getRouteCongestionInfo(Long routeId, LocalDateTime currentTime);

    /**
     * 更新路由拥堵状态
     * 
     * @param routeId 路由ID
     * @param congestionLevel 拥堵等级
     * @param updateTime 更新时间
     * @return 更新结果
     */
    boolean updateRouteCongestionStatus(Long routeId, Integer congestionLevel, LocalDateTime updateTime);

    /**
     * 计算路由距离
     * 
     * @param startLatitude 起点纬度
     * @param startLongitude 起点经度
     * @param endLatitude 终点纬度
     * @param endLongitude 终点经度
     * @return 距离（公里）
     */
    java.math.BigDecimal calculateRouteDistance(java.math.BigDecimal startLatitude, java.math.BigDecimal startLongitude,
                                               java.math.BigDecimal endLatitude, java.math.BigDecimal endLongitude);

    /**
     * 估算路由时间
     * 
     * @param routeId 路由ID
     * @param currentTime 当前时间
     * @param trafficFactor 交通因子
     * @return 预估时间（分钟）
     */
    Integer estimateRouteTime(Long routeId, LocalDateTime currentTime, java.math.BigDecimal trafficFactor);

    /**
     * 查询路由历史数据
     * 
     * @param routeId 路由ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 历史数据
     */
    List<Map<String, Object>> getRouteHistoryData(Long routeId, LocalDateTime startTime, LocalDateTime endTime);

    /**
     * 优化路由
     * 
     * @param routeId 路由ID
     * @param optimizationType 优化类型（1-最短距离，2-最短时间，3-最少费用）
     * @return 优化后的路由
     */
    Map<String, Object> optimizeRoute(Long routeId, Integer optimizationType);

    /**
     * 查询路由备选方案
     * 
     * @param startLatitude 起点纬度
     * @param startLongitude 起点经度
     * @param endLatitude 终点纬度
     * @param endLongitude 终点经度
     * @param limit 限制数量
     * @return 备选路由列表
     */
    List<Map<String, Object>> getAlternativeRoutes(java.math.BigDecimal startLatitude, java.math.BigDecimal startLongitude,
                                                   java.math.BigDecimal endLatitude, java.math.BigDecimal endLongitude, Integer limit);

    /**
     * 更新路由评分
     * 
     * @param routeId 路由ID
     * @param rating 评分
     * @param updateTime 更新时间
     * @return 更新结果
     */
    boolean updateRouteRating(Long routeId, java.math.BigDecimal rating, LocalDateTime updateTime);

    /**
     * 添加路由收藏
     * 
     * @param userId 用户ID
     * @param routeId 路由ID
     * @param createTime 创建时间
     * @return 添加结果
     */
    boolean addRouteFavorite(Long userId, Long routeId, LocalDateTime createTime);

    /**
     * 移除路由收藏
     * 
     * @param userId 用户ID
     * @param routeId 路由ID
     * @return 移除结果
     */
    boolean removeRouteFavorite(Long userId, Long routeId);

    /**
     * 查询用户收藏路由
     * 
     * @param userId 用户ID
     * @param limit 限制数量
     * @return 收藏路由列表
     */
    List<Route> getUserFavoriteRoutes(Long userId, Integer limit);

    /**
     * 查询路由详细信息
     * 
     * @param routeId 路由ID
     * @return 路由详细信息
     */
    Map<String, Object> getRouteDetailInfo(Long routeId);

    /**
     * 批量导入路由
     * 
     * @param routes 路由列表
     * @return 导入结果
     */
    boolean batchImportRoutes(List<Route> routes);

    /**
     * 导出路由数据
     * 
     * @param routeIds 路由ID列表
     * @return 导出数据
     */
    List<Map<String, Object>> exportRouteData(List<Long> routeIds);

    /**
     * 路由数据同步
     * 
     * @param syncType 同步类型
     * @param lastSyncTime 上次同步时间
     * @return 同步结果
     */
    boolean syncRouteData(Integer syncType, LocalDateTime lastSyncTime);

    /**
     * 清理过期路由
     * 
     * @param expireDays 过期天数
     * @return 清理结果
     */
    boolean cleanExpiredRoutes(Integer expireDays);

}